1. Welcome to Jupyter Notebook

This notebook is part of FRETBursts burst analysis software.

Welcome! You are reading a Jupyter Notebook, a document containing narrative, code and the output of code execution. Here you will find a few basic instructions on running FRETBursts notebooks.

Please send feedback and report any problem opening a [FRETBursts Issue](https://github.com/tritemio/FRETBursts/issues) on GitHub.

How to run it?

The notebook is composed of "text cells", such as this paragraph, and "code cells" containing the code to be executed (and identified by an In [ ] prompt).

To execute a code cell, select it and press SHIFT+ENTER. To modify a cell, click on it to go into "edit mode" (indicated by a green frame around the cell), then type. When your are done, SHIFT+ENTER will end the editing.

You can also execute the entire notebook in a single step by using the menu Cell -> Run All.

As an example, try to run the following code cell:


In [ ]:
2 + 2

Finally, for a mini-tour of the various interface elements click on menu Help -> User Interface Tour.

2. Data files

Each FRETBursts notebook is set up to download and analyze a sample data file. To use your own data file, you need to paste its name in the filename variable in the FRETBursts notebook of your choice.


For online users: when running the FRETBursts notebooks online, you need to upload the data file first (if you want to use your own data). The upload procedure varies depending on the size of your file (see next paragraphs).

Online: upload files under 35 MB

Data files up to ~35 MB can be directly uploaded from the dashboard. Just go back to the Home Tab and click on the Upload button on the top right.

Online: upload files over 35 MB

For large files (>35 MB), the upload button will not work. In this case, you have to first upload the file somewhere on the internet, and then copy the file URL in the url variable in the FRETBursts notebook you want to use.

3. Which notebook?

FRETBursts includes several notebooks. We recommend to start with the μs-ALEX notebook which is the most detailed tutorial covering most of the basic aspects of burst analysis.

4. References

Official Jupyter Project Homepage:

Jupyter Homepage

Paper on using notebooks for research:

Interactive notebooks: Sharing the code. Shen (2014) Nature doi:10.1038/515151a

Installing *Jupyter Notebook* on your computer and firsts steps:

Jupyter Notebook Quick-Start Guide